home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmActivateProtocol.z / XmActivateProtocol
Encoding:
Text File  |  2002-10-03  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll - A VendorShell function that activates a
  10.           protocol
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  14.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////PPPPrrrroooottttooooccccoooollllssss....hhhh>>>>
  15.  
  16.           vvvvooooiiiidddd XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll ((((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l))))
  17.                WWWWiiiiddddggggeeeetttt    _s_h_e_l_l;;;;
  18.                AAAAttttoooommmm      _p_r_o_p_e_r_t_y;;;;
  19.                AAAAttttoooommmm      _p_r_o_t_o_c_o_l;;;;
  20.  
  21.           vvvvooooiiiidddd XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeeWWWWMMMMPPPPrrrroooottttooooccccoooollll ((((_s_h_e_l_l, _p_r_o_t_o_c_o_l))))
  22.                WWWWiiiiddddggggeeeetttt    _s_h_e_l_l;;;;
  23.                AAAAttttoooommmm      _p_r_o_t_o_c_o_l;;;;
  24.  
  25.  
  26.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  27.           This page documents version 1.2 of the Motif library.
  28.  
  29.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  30.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll activates a protocol.  It updates the
  31.           handlers and the _p_r_o_p_e_r_t_y if the _s_h_e_l_l is realized.  It is
  32.           sometimes useful to allow a protocol's state information
  33.           (callback lists, and so on) to persist, even though the
  34.           client may choose to temporarily resign from the
  35.           interaction.  This is supported by allowing a _p_r_o_t_o_c_o_l to be
  36.           in one of two states:  active or inactive.  If the _p_r_o_t_o_c_o_l
  37.           is active and the _s_h_e_l_l is realized, the _p_r_o_p_e_r_t_y contains
  38.           the _p_r_o_t_o_c_o_l AAAAttttoooommmm.  If the _p_r_o_t_o_c_o_l is inactive, the AAAAttttoooommmm is
  39.           not present in the _p_r_o_p_e_r_t_y.
  40.  
  41.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeeWWWWMMMMPPPPrrrroooottttooooccccoooollll is a convenience interface.  It calls
  42.           XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll with the property value set to the atom
  43.           returned by interning WWWWMMMM____PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLLSSSS.
  44.  
  45.  
  46.           _s_h_e_l_l  Specifies the widget with which the protocol property
  47.                  is associated.
  48.  
  49.           _p_r_o_p_e_r_t_y
  50.                  Specifies the protocol property.
  51.  
  52.           _p_r_o_t_o_c_o_l
  53.                  Specifies the protocol AAAAttttoooommmm (or an iiiinnnntttt type cast to
  54.                  AAAAttttoooommmm).
  55.  
  56.  
  57.           For a complete definition of VendorShell and its associated
  58.           resources, see VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll((((3333XXXX)))).
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))    UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV    XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  75.           VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll((((3333XXXX)))), XXXXmmmmAAAAccccttttiiiivvvvaaaatttteeeeWWWWMMMMPPPPrrrroooottttooooccccoooollll((((3333XXXX)))) and
  76.           XXXXmmmmIIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((3333XXXX)))).
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.